home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Panorama / Panorama - Disk 14A (1987-02-11)(Pacific North-West Amigas Club)[WB].zip / Panorama - Disk 14A (1987-02-11)(Pacific North-West Amigas Club)[WB].adf / BitCalc.doc < prev    next >
Text File  |  1987-02-08  |  4KB  |  96 lines
  1. BitCalc Version 1.0 - Programmer's Calculator
  2.  
  3. BitCalc is a bit-oriented, multi-function calculator tool for use on the
  4. Amiga computer.  It's capabilities include:
  5.  
  6.        - Word sizes of 8, 16, or 32 bits
  7.        - Numbers can be displayed in binary, octal, decimal, or hexadecimal
  8.        - Four register stack with reverse polish notation (RPN)
  9.        - Single memory register
  10.        - 12 Numeric functions
  11.        - Full 32 digit display
  12.        - Integers only!
  13.        - Keyboard or mouse input
  14.  
  15. BitCalc can be run from either the CLI or Workbench (1.1 or 1.2).  Although
  16. I've never tried it, BitCalc should work on a 256K machine with no problem.
  17. To use BitCalc, either double click it from the Workbench or type RUN BITCALC
  18. from the CLI.
  19.  
  20. I have not yet done any fancy rendering of the keys, so for now most of the
  21. keys are marked with the standard 'C' operators. The following is a summary
  22. of the keys:
  23.  
  24.     0 thru F: Digit entry keys
  25.           - : Subtract X from Y
  26.           + : Add X to Y
  27.           * : Multiply X times Y
  28.           / : Divide X into Y
  29.           CL: Clear X Register
  30.           RD: Roll Down
  31.           EN: Enter
  32.           <-: Clear Last Digit
  33.           XY: Swap X with Y
  34.           +-: Change Sign of X
  35.           MS: Store X to Memory
  36.           <<: Logical Shift Left X
  37.           >>: Logical Shift Right X
  38.           % : Y mod X
  39.           MR: Recall X from Memory
  40.           & : Y AND X (bitwise)
  41.           | : Y OR X (bitwise)
  42.           ^ : Y XOR X (bitwise)
  43.           ! : NOT X (bitwise)
  44.    2,8,10,16: Number Base
  45.      8,16,32: Word Size (bits)
  46.           ? : Help Screen
  47.  
  48. This same list of keys can be obtained by selecting the ? key or by selecting
  49. help from the project menu.
  50.  
  51. Notes about BitCalc:
  52.  
  53. - All numbers are displayed as positive values with one exception;  If a 32
  54.   bit number has it's most significant bit set and the number is displayed
  55.   in base 10, then it will be shown as a negative value.
  56.  
  57. - For a given base, only the appropriate digit keys will work, i.e. in base
  58.   2, only 0 and 1 will work, in base 8, only 0 thru 7 will work, etc.
  59.  
  60. - There is no indication in the event of an overflow, any bits greater than
  61.   the word size (8, 16, or 32) are lost into the cosmic void.  In other
  62.   words, if the word size is 8 bits and the base is ten, then multiplying
  63.   100 by 100 will give an answer of 16 (which is the low 8 bits of 10,000).
  64.  
  65. - Digit entry is not allowed if it would cause an overflow.  For example, if
  66.   the word size is 8 bits then you can not type in a number greater than
  67.   255 decimal.   
  68.  
  69. - BitCalc has a four register stack.  The registers are labeled X, Y, Z, and
  70.   T.  Usage is similar to Hewlett-Packard (Trademark) calculators.  All two
  71.   register operations will put the result in X, copy Z to Y, and copy T to Z.
  72.   Single register operations work on the X register only.  The other
  73.   registers are unaffected.
  74.  
  75. - Most BitCalc functions can be accessed using the keyboard as well as the
  76.   mouse.
  77.  
  78. - Number base conversions can be accomplished by entering a number in a
  79.   given base, and then selecting a different base.  For example, select
  80.   base 10 and enter 12345. Then select base 2 to see the same number in
  81.   binary, select base 8 to see it in octal, or select base 16 to see it in
  82.   hexadecimal.
  83.  
  84. BitCalc Programmers Calculator is a copyright of John Champion.  All rights
  85. are reserved.  However, BitCalc may be freely distributed so long as the
  86. distribution is not for personal gain or profit.  Please send comments, bug
  87. reports, problems (related to BitCalc), or $5 if you think it's worth it to:
  88.  
  89.       John Champion
  90.   12921 Monterey Circle
  91.  Anchorage, Alaska 99516
  92.   (Voice) 907-345-2106
  93.  
  94. BitCalc is written in Lattice C. Source code is available to supporting
  95. users by contacting me at the above address.
  96.